<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Language" content="zh-CN" />
<link href="style/css/manual-zip.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
<link href="style/css/manual-zip-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
<link href="style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<title>Apache的环境变量 － Apache 2.2 中文手册 [金步国]</title>
<script> var _hmt = _hmt || []; (function() { var hm = document.createElement("script"); hm.src = "https://hm.baidu.com/hm.js?d286c55b63a3c54a1e43d10d4c203e75"; var s = document.getElementsByTagName("script")[0]; s.parentNode.insertBefore(hm, s); })(); </script>
</head>
<body id="manual-page">
<div id="page-header"><p class="menu"><a href="mod/index.html">模块索引</a> | <a href="mod/directives.html">指令索引</a> | <a href="faq/index.html">常见问题</a> | <a href="glossary.html">词汇表</a> | <a href="sitemap.html">站点导航</a></p><p class="apache">Apache HTTP Server 版本2.2</p><img alt="" src="images/feather.gif" /></div>
<div class="up"><a href="index.html"><img title="&lt;-" alt="&lt;-" src="images/left.gif" /></a></div>
<div id="path"><a href="https://www.apache.org/">Apache</a> &gt; <a href="https://httpd.apache.org/">HTTP Server</a> &gt; <a href="https://httpd.apache.org/docs/">文档</a> &gt; <a href="index.html">版本2.2</a></div>

<div id="translation-info">　　 <a href="translator_announcement.html#thanks">致谢</a> | 本篇译者：<a href="../../index.html">金步国</a>(<a href="../../index.html">作品集</a>) | 本页最后更新：2008年8月11日</div>
<div id="page-content"><div id="preamble"><h1>Apache的环境变量</h1>


    <p>Apache HTTP服务器提供了一个机制，可以把信息存储在叫做<em>环境变量</em>(environment variable)的命名变量中。这个信息可以用于控制诸如日志记录和访问控制之类的操作。此外，还可以作为一个和诸如CGI脚本这样的外部程序进行沟通的机制。本文档讨论了操作和使用这些变量的不同方法。</p>

    <p>尽管这些变量也被称作<em>环境变量</em>，但它们和底层的、由操作系统控制的环境变量不能混为一谈。这些变量仅在Apache内部被存储和操纵。仅当它们被提供给外部CGI脚本或服务器端包含脚本(SSI)时，才会变成真正的操作系统环境变量。如果你想操作作为服务器运行基础的操作系统的环境变量，你必须使用由你的操作系统shell提供的标准环境操作机制。</p>
  </div>
	<div class="top"><a href="env.html#page-header"><img alt="top" src="images/up.gif" /></a></div>
<div class="section">
<h2><a name="setting" id="setting">设置环境变量</a></h2>

    <table border="1" cellpadding="0" cellspacing="0" bordercolor="#AAAAAA" class="related">
<tr><th>相关模块</th><th>相关指令</th></tr>
<tr><td><ul><li><code class="module"><a href="mod/mod_env.html">mod_env</a></code></li><li><code class="module"><a href="mod/mod_rewrite.html">mod_rewrite</a></code></li><li><code class="module"><a href="mod/mod_setenvif.html">mod_setenvif</a></code></li><li><code class="module"><a href="mod/mod_unique_id.html">mod_unique_id</a></code></li></ul></td><td><ul><li><code class="directive"><a href="mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code></li><li><code class="directive"><a href="mod/mod_setenvif.html#browsermatchnocase">BrowserMatchNoCase</a></code></li><li><code class="directive"><a href="mod/mod_env.html#passenv">PassEnv</a></code></li><li><code class="directive"><a href="mod/mod_rewrite.html#rewriterule">RewriteRule</a></code></li><li><code class="directive"><a href="mod/mod_env.html#setenv">SetEnv</a></code></li><li><code class="directive"><a href="mod/mod_setenvif.html#setenvif">SetEnvIf</a></code></li><li><code class="directive"><a href="mod/mod_setenvif.html#setenvifnocase">SetEnvIfNoCase</a></code></li><li><code class="directive"><a href="mod/mod_env.html#unsetenv">UnsetEnv</a></code></li></ul></td></tr>
</table>

    <h3><a name="basic-manipulation" id="basic-manipulation">基本的环境变量操作</a></h3>

        <p>设置一个Apache环境变量最基本的方法，就是使用没有什么限制的<code class="directive"><a href="mod/mod_env.html#setenv">SetEnv</a></code>指令。也可以使用<code class="directive"><a href="mod/mod_env.html#passenv">PassEnv</a></code>指令将启动Apache的操作系统shell的环境变量传进来。</p>


    	<h3><a name="conditional" id="conditional">针对每个请求进行有条件的设定</a></h3>

        <p>为了具有额外的伸缩性，<code>mod_setenvif</code> 提供的指令允许针对每个请求特定的请求特性进行环境变量的设定。比如，可以仅在一个特定的浏览器(User-Agent)进行请求时，或仅在一个特定的"Referer:"头被发现时进行环境变量的设置。如果使用<code>mod_rewrite</code>的<code class="directive"><a href="mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>指令中的 <code>[E=...]</code> 选项来进行环境变量的设置，还会具有更大伸缩性。</p>


    	<h3><a name="unique-identifiers" id="unique-identifiers">唯一标识符</a></h3>


        <p>最后，<code>mod_unique_id</code>将为每个请求设定一个<code>UNIQUE_ID</code>环境变量的值，这个值对"所有"请求都是唯一的，即使在极为特定的条件下。</p>


    <h3><a name="standard-cgi" id="standard-cgi">标准CGI变量</a></h3>


        <p>除了所有Apache配置中的环境变量和由操作系统shell传进来的环境变量之外，还有一组环境变量是提供给CGI脚本和SSI页面的，此组环境变量包含由<a href="http://cgi-spec.golux.com/">CGI规范</a>要求的与请求相关的元信息。</p>


    	<h3><a name="caveats" id="caveats">一些告诫</a></h3>


        <ul>
          <li>用环境变量操作指令来覆盖或修改标准的CGI变量是行不通的。</li>

          <li>当用<code class="program"><a href="programs/suexec.html">suexec</a></code>来运行CGI脚本时，环境变量将会被清除到在CGI脚本运行之前只剩一组<em>安全</em>变量。<em>安全</em>变量的列表在编译时由suexec.c定义。</li>

          <li>出于可移植性的考虑，环境变量的命名必须仅包含字母、数字、下划线。此外，第一个符号不能为数字。不符合此要求的字符将在传递给CGI脚本和SSI页面时被下划线取代。</li>
          <li>由于<code class="directive"><a href="mod/mod_env.html#setenv">SetEnv</a></code>指令在请求处理的后期才运行，所以诸如<code class="directive"><a href="mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>和<code class="directive"><a href="mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>之类的指令将看不到<code class="directive"><a href="mod/mod_env.html#setenv">SetEnv</a></code>指令设置的变量。</li>
        </ul>

  </div><div class="top"><a href="env.html#page-header"><img alt="top" src="images/up.gif" /></a></div>
<div class="section">
<h2><a name="using" id="using">使用环境变量</a></h2>


    <table border="1" cellpadding="0" cellspacing="0" bordercolor="#AAAAAA" class="related">
<tr><th>相关模块</th><th>相关指令</th></tr>
<tr><td><ul><li><code class="module"><a href="mod/mod_authz_host.html">mod_authz_host</a></code></li><li><code class="module"><a href="mod/mod_cgi.html">mod_cgi</a></code></li><li><code class="module"><a href="mod/mod_ext_filter.html">mod_ext_filter</a></code></li><li><code class="module"><a href="mod/mod_headers.html">mod_headers</a></code></li><li><code class="module"><a href="mod/mod_include.html">mod_include</a></code></li><li><code class="module"><a href="mod/mod_log_config.html">mod_log_config</a></code></li><li><code class="module"><a href="mod/mod_rewrite.html">mod_rewrite</a></code></li></ul></td><td><ul><li><code class="directive"><a href="mod/mod_authz_host.html#allow">Allow</a></code></li><li><code class="directive"><a href="mod/mod_log_config.html#customlog">CustomLog</a></code></li><li><code class="directive"><a href="mod/mod_authz_host.html#deny">Deny</a></code></li><li><code class="directive"><a href="mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code></li><li><code class="directive"><a href="mod/mod_headers.html#header">Header</a></code></li><li><code class="directive"><a href="mod/mod_log_config.html#logformat">LogFormat</a></code></li><li><code class="directive"><a href="mod/mod_rewrite.html#rewritecond">RewriteCond</a></code></li><li><code class="directive"><a href="mod/mod_rewrite.html#rewriterule">RewriteRule</a></code></li></ul></td></tr>
</table>

    <h3><a name="cgi-scripts" id="cgi-scripts">CGI脚本</a></h3>


        <p>环境变量的主要用途之一就是把信息传递给CGI脚本。如前所述，递给CGI脚本的环境变量，除了在Apache配置中定义的以外，还包含一组与请求相关的标准元信息的环境变量。更多细节请参见<a href="howto/cgi.html">CGI教程</a>。</p>


    <h3><a name="ssi-pages" id="ssi-pages">SSI页面</a></h3>


        <p>由mod_include的<code>INCLUDES</code>过滤器处理的服务器端解析(Server-parsed[SSI])文档能够用<code>echo</code>元素打印出环境变量，并能在流程控制元素中使用环境变量来基于请求特性而产生部分页面。Apache当然也会将上述的标准CGI环境变量提供给SSI页面。更多细节请参见<a href="howto/ssi.html">SSI教程</a>。</p>


    <h3><a name="access-control" id="access-control">访问控制</a></h3>


        <p>可以用 <code>allow from env=</code> 和 <code>deny from env=</code> 指令基于环境变量的值对服务器进行访问控制。在结合了<code class="directive"><a href="mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>之后，能更灵活的基于客户端特性对服务器进行访问控制。比如，你能用这些指令来拒绝一些特定浏览器(User-Agent)的访问。</p>


    	<h3><a name="logging" id="logging">条件日志记录</a></h3>


        <p>可以用<code class="directive"><a href="mod/mod_log_config.html#logformat">LogFormat</a></code>的可选项"<code>%e</code>"将环境变量写入访问日志中。此外，还可以用<code class="directive"><a href="mod/mod_log_config.html#customlog">CustomLog</a></code>指令基于环境变量的状态来决定是否将请求写入日志。在结合了<code class="directive"><a href="mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>之后，能更灵活的控制哪些请求将被记录。比如，你可以选择不对以<code>gif</code>为结尾的文件名请求进行记录，或者选择只记录内网之外的客户端请求。</p>


    	<h3><a name="response-headers" id="response-headers">条件响应头</a></h3>


        <p><code class="directive"><a href="mod/mod_headers.html#header">Header</a></code>指令能根据一个环境变量是否存在来决定是否将一个HTTP头放入对客户端的响应里。这将使诸如从客户端收到特定的请求头时返回特定的应答头这样的事情成为可能。</p>

    <h3><a name="external-filter" id="external-filter">外部过滤器的激活</a></h3>

        <p>由<code class="module"><a href="mod/mod_ext_filter.html">mod_ext_filter</a></code>的<code class="directive"><a href="mod/mod_ext_filter.html#extfilterdefine">ExtFilterDefine</a></code>指令配置的外部过滤器可以用 <code>disableenv=</code> 和 <code>enableenv=</code> 选项根据环境变量的条件进行激活。</p>


    	<h3><a name="url-rewriting" id="url-rewriting">URL重写</a></h3>


        <p><code class="directive"><a href="mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>中形如 <code>%{ENV:...}</code> 的<em>TestString</em>允许mod_rewrite的重写引擎以环境变量为条件进行决策。注意：mod_rewrite内部可以访问但没有以 <code>ENV:</code> 开头的那些变量并不是真正的环境变量。它们只是mod_rewrite特有的变量而不能被其他模块所访问。</p>

  </div><div class="top"><a href="env.html#page-header"><img alt="top" src="images/up.gif" /></a></div>
<div class="section">
<h2><a name="special" id="special">用于特殊目的的环境变量</a></h2>

        <p>由于互操作性的问题，在针对特定客户端的处理中，引入了一套修正Apache行为的机制。为了使这些机制尽量灵活，它们将通过环境变量的定义而激活。比如，典型的示例有<code class="directive"><a href="mod/mod_setenvif.html#browsermatch">BrowserMatch</a></code> ，尽管<code class="directive"><a href="mod/mod_env.html#setenv">SetEnv</a></code>和<code class="directive"><a href="mod/mod_env.html#passenv">PassEnv</a></code>也能使用。</p>

    	<h3><a name="downgrade" id="downgrade">downgrade-1.0</a></h3>
        <p>即使这个请求符合更新的标准，也强制把它当作一个HTTP/1.0请求来处理。</p>


    	<h3><a name="force-gzip" id="force-gzip">force-gzip</a></h3>
          <p>如果你激活了<code>DEFLATE</code>过滤器，这个环境变量将忽略浏览器的accept-encoding设置而无条件的使用经过gzip压缩的输出。</p>

    <h3><a name="force-no-vary" id="force-no-vary">force-no-vary</a></h3>
        <p>此变量在将应答送回客户端之前删除所有的<code>Vary</code>头字段。一些客户端不能正确地解析此头字段。此变量的设定将解决此问题，它同时隐含设置了<strong>force-response-1.0</strong>。</p>


    <h3><a name="force-response" id="force-response">force-response-1.0</a></h3>
      <p>设定该变量可以在客户端发送HTTP/1.0请求时，强制进行HTTP/1.0响应。它的实现源于一个AOL的代理产生的问题。一些HTTP/1.0客户端在收到HTTP/1.1的响应后会有不正常的举动。而设定此变量能够解决这一问题。</p>


    <h3><a name="gzip-only-text-html" id="gzip-only-text-html">gzip-only-text/html</a></h3>
        <p>当该变量为"1"时，将禁止<code>text/html</code>之外的内容类型使用由<code class="module"><a href="mod/mod_deflate.html">mod_deflate</a></code>提供的<code>DEFLATE</code>输出过滤器。如果你更喜欢使用静态的压缩文件；<code class="module"><a href="mod/mod_negotiation.html">mod_negotiation</a></code>也同样使用该变量(不单单是gzip，而是所有不具有"同一性"的编码)。</p>


    	<h3><a name="no-gzip" id="no-gzip">no-gzip</a></h3>
        <p>如果设置了此变量，<code class="module"><a href="mod/mod_deflate.html">mod_deflate</a></code>中的<code>DEFLATE</code>过滤器将被禁用，同时<code class="module"><a href="mod/mod_negotiation.html">mod_negotiation</a></code>将拒绝发送经过编码的资源。</p>


    <h3><a name="nokeepalive" id="nokeepalive">nokeepalive</a></h3>
        <p>如果设置了此变量，<code class="directive"><a href="mod/core.html#keepalive">KeepAlive</a></code>将被禁用。</p>



    <h3><a name="prefer-language" id="prefer-language">prefer-language</a></h3>
        <p>此变量将影响<code class="module"><a href="mod/mod_negotiation.html">mod_negotiation</a></code>的行为。如果它包含一个语言标签(如：<code>en</code>、<code>fr</code>、<code>zh_cn</code>、<code>x-方言</code>)，<code class="module"><a href="mod/mod_negotiation.html">mod_negotiation</a></code>将尝试发送一个标签指定的语言的变种，如果不存在这样的变种，则使用通常的<a href="content-negotiation.html">内容协商</a>处理过程。</p>


    	<h3><a name="redirect-carefully" id="redirect-carefully">redirect-carefully</a></h3>
        <p>此变量将使服务器在对客户端发送重定向命令时更加小心。典型应用于已知客户端在处理重定向指令时会存在问题的情况下。它的实现源于微软的WebFolders软件存在的一个问题。它在经由DAV方法在目录资源上处理重定向命令时会有问题。</p>


   <h3><a name="suppress-error-charset" id="suppress-error-charset">suppress-error-charset</a></h3>
    <p><em>仅存在于2.0.54后的版本中</em></p>
    <p>当Apache针对用户请求响应一个重定向命令的时候，这个响应中包含了一些文字。这些文字将在客户端不能(或没有)自动执行重定向操作的情况下显示。Apache会将这段文字按照ISO-8859-1字符集进行编码。</p>
    <p>然而，如果重定向的目的页面使用了不同的字符集，一些有问题的浏览器版本会使用重定向命令文本的字符集，而不是采用目的页面的字符集。比如，希腊文就不会被正确显示。</p>
    <p>设置此环境变量将使Apache略过重定向命令文本的字符集设置，这样这些有问题的浏览器就会正确的使用目的页的字符集。</p>
    <div class="warning"><h3>安全提示</h3>
     <p>发送未指定字符编码的错误页面可能会在某些不严格遵守HTTP/1.1规范的浏览器(MSIE)上导致跨站脚本攻击，因为这些浏览器会企图"猜测"正确的编码。在使用UTF-7字符集的时候，这些浏览器就很容易被愚弄：UTF-7格式的输入数据不会被正确转义，而这些转义原本的目的就是为了防止跨站脚本攻击。</p>
    </div>

   	<h3><a name="proxy" id="proxy">force-proxy-request-1.0, proxy-nokeepalive, proxy-sendchunked, proxy-sendcl</a></h3>
   <p>这些指令改变了<code class="module"><a href="mod/mod_proxy.html">mod_proxy</a></code>协议的行为，参见<code class="module"><a href="mod/mod_proxy.html">mod_proxy</a></code>文档以获得更多细节。</p>


  </div><div class="top"><a href="env.html#page-header"><img alt="top" src="images/up.gif" /></a></div>
<div class="section">
<h2><a name="examples" id="examples">示例</a></h2>


    <h3><a name="misbehaving" id="misbehaving">针对表现不恰当的客户端改变协议的行为</a></h3>


        <p>早期的版本建议将以下示例包含到httpd.conf中以解决一些已知的客户端问题。但是这些存在问题的客户端现在基本上已经绝种了，所以，下列示例也就没有存在的必要了。</p>
<div class="example"><pre>
# 下面的指令将会修改HTTP的普通响应方式。
# 第一个指令为Netscape 2.x浏览器禁用keepalive特性，因为它不能正确处理。
# 第二个指令用于IE4.0，因为它也不能对HTTP/1.1的301/302(重定向)应答正确处理keepalive。
BrowserMatch "Mozilla/2" nokeepalive
BrowserMatch "MSIE 4\.0b2;" nokeepalive downgrade-1.0 force-response-1.0

# 下面的指令为违反HTTP/1.0规范的浏览器禁用HTTP/1.1应答。
BrowserMatch "RealPlayer 4\.0" force-response-1.0
BrowserMatch "Java/1\.0" force-response-1.0
BrowserMatch "JDK/1\.0" force-response-1.0</pre></div>


    <h3><a name="no-img-log" id="no-img-log">不在访问日志中记录对图片的请求</a></h3>


        <p>以下示例将避免将对图片的请求记入访问日志中。你修改一下就可以将它用于避免特定目录或特定主机的请求被记入日志。</p>
    	<div class="example"><pre>
SetEnvIf Request_URI \.gif image-request
SetEnvIf Request_URI \.jpg image-request
SetEnvIf Request_URI \.png image-request
CustomLog logs/access_log common env=!image-request</pre></div>


    <h3><a name="image-theft" id="image-theft">阻止"图片大盗"</a></h3>


        <p>下例展示了如何避免不在你服务器上的人在他们的站点中直接引用你服务器上的图片。这不是一个推荐的配置，但它能在有限的环境中加以应用。我们假设你所有的图片都在/web/images目录下。</p>
    	<div class="example"><pre>
SetEnvIf Referer "^http://www\.example\.com/" local_referal
# 允许未发送Referer头的浏览器
SetEnvIf Referer "^$" local_referal
&lt;Directory /web/images&gt;
   Order Deny,Allow
   Deny from all
   Allow from env=local_referal
&lt;/Directory&gt;</pre></div>

        <p>想得知此技术的更多信息，请参阅"今日Apache教程" <a href="http://apachetoday.com/news_story.php3?ltsn=2000-06-14-002-01-PS">《保护你的图片不为他人所用》</a>。</p>

  </div></div>
<div id="footer">
<p class="apache">本文允许自由的转载、引用、再分发，但必须保留译者署名并注明出处；详见：<a href="translator_announcement.html#announcement">版权声明</a>。</p>
<p class="menu"><a href="mod/index.html">模块索引</a> | <a href="mod/directives.html">指令索引</a> | <a href="faq/index.html">常见问题</a> | <a href="glossary.html">词汇表</a> | <a href="sitemap.html">站点导航</a></p></div>
</body></html>
